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This publication describes programming ser- 
vices for using the IBM 2260 Display Station 
with the System/360 Operating System. Included 
are descriptions of macro-instructions for 
input/output control and for Basic Attention 
Handling, along with some general requirements 
for using the display station effectively. 

Although intended primarily for the program- 
mer coding in System/360 assembler language,, 
portions of this publication are also of inter- 
est to installation managers, system engineers, 
system programmers, and others seeking general 
information about programming the IBM 2260 
Display Station. 




PREFACE 



This publication provides the reader 
with instructions and guidance in writ- 
ing applications programs for the IBM 
2260 Display Station (local attachment) 
under overall control of the IBM 
System/360 Operating System, The macro- 
instructions and control program 
routines supplied are described in 
detail. Coding examples with accompany- 
ing explanations are included to illus- 
trate uses of the macro-instructions and 
other modules provided. 

To take full advantage of the operat- 
ing system and the programming services 
provided specifically for the IBM 2260, 
the reader should have completed a basic 
course in System/360 assembler language 
coding, or possess equivalent knowledge. 



and be familiar with the content of the 
following publications: 



IBM System/360 Component Description; 

IBM 2260 Display Station, IBM 2848 

Display Control , Form A27-2700 
IBM System/360 Operating System; 

Concepts and Facilities , Form 

C28-6535 
IBM System/360 Operating System; 

Assembler Language , Form C28-6514 
IBM System/360 Operating System; 

Control Program Services , Form 

C28-6541 
IBM System/360 Operating System; Job 

Control Language , Form C28-6539 
IBM System/360 Operating System; 

Linkage Editor , Form C28-6538 



Third Edition (September 1966) 

This is a major revision of, and obsoletes, IBM Sys- 
tem/360 Operating System; Graphic Programming Services 
for IBM 2260 Display Station (Local Attachment) ; Pre- 
liminary Specifications , Form C27-6912-1. Significant 
changes have been made throughout the present edition. 
Express attention handling is not discussed in this 
publication, but is described in IBM System/360 
Operating System; Express Graphic Programming Services 
for IBM 2260 Display Station (Local Attachment) , Form 
C27-6925. 
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GENERAL INFORMATION 



The programming support described in 
this publication may be used with one or 
more IBM 2260 Display Stations connected 
to IBM System/360, Each display station 
is associated with an IBM 2848 Display 
Control , which is connected directly to 
the processing unit via either a multi- 
plexor channel or a selector channel. 

In this configuration, which is 
referred to as the "IBM 2260 Local," the 
display station may be located anywhere 
within a 2000-foot cable distance from 
the display control. 

Through use of the IBM 27 01 Data 
Adaptor Unit and appropriate common car- 
rier facilities, display stations may be 
located any distance from the central 
processing unit. This configuration, 
which is referred to as the "IBM 2260 
Remote, " is supported under the Basic 
Telecommunications Access Method (BTAM). 



CONFIGURATIONS AND FEATURES 



The display station is available in 
three configurations, consisting of a 
cathode ray tube (CRT) display with or 
without an alphameric or numeric key- 
board. The optional keyboard enables 
man- machine communication on a continu- 
ing basis at the display station. Other 
special features available with the IBM 
2260 Local are Line Addressing and Non- 
destructive Cursor. 

The IBM 2848 Display Control contains 
the interface control, a character gen- 
erator, and buffer storage for the dis- 
play stations. This buffer storage 
retains the video data to maintain dis- 
play regeneration on the CRT. The data 
formats and number of characters that 
may be displayed on the face of the CRT, 
as well as the number of display sta- 
tions that may be attached to a single 
display control, depend upon which of 
the three models of the display control 
is used, as shown in Table 1. 

In addition, one IBM 1053 Printer 
Adapter Unit may be attached to each 
display control. This feature allows 
use of an IBM 1053 Printer at a central 



location to document and record periodic 
system transactions. Like the display 
stations, the 1053 Printer may be locat- 
ed up to 2000 feet from the display 
control. 

The programming services described in 
this publication support all of the 
optional features of both the IBM 2260 
and the IBM 2848 described in detail in 
the component description publication, 
Form A27-2700. 



PROGRAMMING SUPPORT 



Operating system programming support 
for the IBM 2260 Display Station in- 
cludes macro-instructions and control 
routines. They are used for two key 
functions: input/output control and at- 
tention handling. The macro-instruc- 
tions function as part of the problem 
program; the control routines function 
as part of the control program. 

The following paragraphs contain 
brief descriptions of the graphic pro- 
gramming services that are explained in 
detail in later sections. Appendixes 
include a sample program and CCW for- 
mats. 

Table 1. Display Control Charac- 
teristics 



IBM 2848 Display Control 



t t t 

Characteristic | Model 1| Model 2 | Model 3 
j. + + + 

Max. No. of 

Display j 24 j 

Stations j j 

No. of Lines j 6 j 
of Characters 



h 



NO. Of 

Characters 
Per Line 

Total 
No. of 
Characters 



16 



12 



40 j 40 
I 

I 
240 j 480 



— +■ 



.| 

12 



H 



80 
960 
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INPUT/OUTPUT CONTROL 



SYSTEM GENERATION 



Input/output control macro- instruc- 
tions are used for data transmission and 
control functions, for creating data 
control blocks (DCBs) # and for estab- 
lishing and terminating system commu- 
nication between problem programs and 
display stations. Input/output control 
routines create channel command words 
(CCWs), issue supervisor calls to 
execute channel programs, and control 
data transmission between main storage 
and display station buffer storage. 



The IBM 2260 user defines 
configuration to the operati 
is generating through use of 
SYSGEN macro- instructions, 
eration requirements are 
the publication IBM System/3 
System; System , Generation , 
6554. 



CONVENTIONS USED 



his graphic 
ng system he 

appropriate 
System gen- 
described in 
60 Operating 



Form C28- 



BASIC ATTENTION HANDLING 



An understanding of the following 
conventions is helpful in using the 
information supplied in this publica- 
tion. 



Attentions are asynchronous (unsched- 
uled) input/output interruptions of the 
CPU. They are caused by alphameric or 
numeric keyboard entries from the 2260 
Display Station. 

Basic attention handling facilities 
automatically detect the occurrence of 
attentions, and route them to appropri- 
ate user-written attention handling rou- 
tines. They also provide for queuing 
attentions that occur within a short 
time interval, and for overlapping wait 
intervals for expected attentions with 
selective processing. Macro- instruc- 
tions define the user's attention han- 
dling routines to the control program. 



ERROR HANDLING 



Synchronous errors (i.e., input/ 
output errors that occur during channel 
operations) are handled by the IBM 2260 
Standard Error routine. This module 
analyzes the status and sense bytes for 
synchronous error conditions and pro- 
vides appropriate error-recovery proce- 
dures for specific error situations. 

The IBM 2260 Standard Error routine 
provides a message to the operator when- 
ever operator intervention is required, 
or whenever a Bus Out Check or Equipment 
Check occurs. These messages appear in 
the publication IBM System/360 Operating 
System; Operator's Guide , Form C28-6540. 



FORMAT ILLUSTRATION CONVENTIONS 



Each macro-instruction discussed in 
this publication is illustrated by a 
coding format. The coding format illus- 
trations use the following conventions: 

• Upper case (capital) letters, num- 
bers, and punctuation marks must be 
coded by the programmer exactly as 
shown. Exceptions to this conven- 
tion are brackets, [ ], braces { }, 
and ellipses, ... . These three 
exceptions are never coded. 

• Lower case (small) letters and words 
represent variables for which spe- 
cific information or specific values 
must be substituted by the program- 
mer when coding. 

• Items or groups of items within 
brackets, [ ] ,, are optional. They 
may be omitted at the programmer's 
discretion. 

• Braces, { } , indicate that one oper- 
and from the group must be chosen 
unless a default option is indicat- 
ed. 

• Underscoring indicates a default 
option; that is, if no operand is 
coded, the underscored operand is 
assumed. 

• The vertical stroke ( | ) signifies 
exclusive "or." For example, A|B 
means that the programmer may write 



A or B. Alternative operands are 
also indicated, in some cases, by 
vertical grouping within braces, 
{ }. 

• An ellipsis, ... , denotes that the 
preceding syntactical unit (which is 
enclosed in braces or brackets) can 
be written any number of times. 

• Operands are separated by commas. 

• All operands are written on one line 
of a coding sheet (except when a 
continuation card is necessary) even 
though they may appear on two or 
more lines in the format illustra- 
tion. 



tion operands, these are decimal inte- 
gers and need not be preceded by leading 
zeros. 

Unless otherwise specified, omission 
of the macro-form (MF) operand causes a 
macro-instruction to perform both L and 
E functions, i.e-, to derive a parameter 
list from all the operands specified 
and, at execution time, to execute the 
macro-instruction using that list. 



LINKAGE CONVENTIONS 



• The last operand is always followed 
by a blank. 



CODING CONVENTIONS 



Positional operands must be coded in 
the order shown in the appropriate for- 
mat illustration. Keyword operands may 
be written in any order, but must follow 
all positional operands. Commas must 
appear in place of omitted operands 
preceding the last-specified positional 
operand. 

Where value mnemonics are used to 
describe macro-instruction operands, the 
mnemonics used are those defined in 
Section 1 of IBM System/360 Operating 
System; Control Program Services , Form 
C28-6541. Whenever the L-form of a 
macro- instruction is specified (MF=L) , 
no indexing or register notation is 
permitted for its operands; only relo- 
catable expressions, absolute expres- 
sions, or codes may be used. 

Unless noted otherwise, where numeric 
values are indicated as macro- instruc- 



Linkage conventions described in IBM 
System/36 Operating System; Control 
Program Services apply to the program- 
ming support described here. Informa- 
tion about register assignments for 
specific linkage functions can be found 
in that publication. 



TERMINOLOGY 



In this publication, "display station 
buffer storage" refers to the buffer 
storage physically located in the dis- 
play control unit. Throughout this pub- 
lication, the unqualified term "reg- 
ister" means "general register." 

A glossary is included at the end of 
this publication to define certain terms 
that are peculiar to graphic-device pro- 
gramming and that may be unfamiliar to 
the reader. Those terms that are found 
both in this and in other operating 
system publications are defined in the 
glossary contained in IBM System/360 



Operating System; Concepts 
ties. 



and Facili- 



General Information 



INPUT/OUTPUT CONTROL 



Input/output control is achieved by 
macro- instructions and associated con- 
trol routines which together initiate 
input/output operations associated with 
data display. Input/output macro- 
instructions for the IBM 2260 Display 
Station are: 



Macro- 

Instruction 

DCB 



Function 



Establishes the format and 
reserves space for the 
data control block. 

OPEN Opens the DCBs for the 
display stations by set- 
ting up necessary control 
blocks and informing the 
operating system that the 
problem program will use 
the display stations. 

GREAD Reads manual input character 
data from display station 
buffer storage to main 
storage; or, 
Reads character data from 
display station buffer 
storage to main storage. 

GWRITE Writes character data into 
display station buffer 
storage; or, 
Erases the display station 
buffer storage and then 
writes; or, 
Writes into the display sta- 
tion buffer at the first 
display position of a 
specified line; or, 
Erases the display station 
buffer storage, then 
writes into the display 
station buffer at the 
first display position of 
a specified line. 

GCNTRL Erases display station buf- 
fer storage. 

CLOSE Resets the fields initial- 
ized by OPEN and informs 
the operating system that 
the problem program no 
longer needs the display 
stations. 



Note: The address of the problem pro- 
gram save area must be loaded into 
register 13 before any input/output 
macro- instruction is issued. 



FUNCTIONAL RELATIONSHIPS 



To help the reader better understand 
subsequent discussion of input/output 
operations, the following paragraphs 
briefly describe the functional rela- 
tionships among the various system con- 
trol blocks associated with 2260 
input/output operations under the oper- 
ating system. Additional information 
may be found in the "Execute Channel 
Program" section of the IBM System/360 
Operating System; System Programmer's 
Guide , Form C2 8-6 550. 

Each data control block (DCB) normal- 
ly is established by a DCB macro- 
instruction and completed by execution 
of an OPEN macro-instruction. The DCB, 
which contains a reference to a DD 
statement (see below), may be associated 
with one display station or with a group 
of display stations connected to a 
single 2848 display control. More than 
one DCB may be completed by a single 
OPEN macro-instruction. The OPEN macro- 
instruction creates a data extent block 
(DEB) in protected core storage. 
Included in the DEB is a table of 
address pointers to specific unit con- 
trol blocks (UCBs) associated with the 
data control block. One UCB is speci- 
fied for each display station and for 
each 1053 Printer attached to a 2848 
Display Control. The UCB is used to 
describe its associated device to the 
control program. 

Some input/output macro-instructions 
contain a "unit" operand. The "unit" 
operand refers to a device within a 
group of devices which can be named at 
system generation time. This operand is 
used as an index to reference the 
desired element in the DEB list of UCB 
pointers. The value of the "unit" oper- 
and, expressed as a decimal integer, 
must not exceed the number of devices 
specified on the Data Definition (DD) 
card for the data set. 

A DD statement can refer to any 
display station or 1053 Printer singu- 
larly, or to any group of display sta- 
tions (up to 24) along with a 1053 
Printer connected to the same display 
control. All units of a group need not 



Table 2. Format of the DECB 



r~ 


Offset 


from 


-T 


— T _ 






DECB Name 






Associated I/O Macro- 


i 


( bytes 


5) 


| DECB Field 


4. 


Instruction Operand 


I 


+ 00 




T 

| Event control block (ECB) 
j address 


T 






+ 04 




| Type code 




type 




+ 08 




| Data control block (DCB) 
| address 




deb 




+ 12 




| Area address 




area 




+16 




| Code for incorrect length or 
| permanent read error 








+ 17 




| Residual count from CSW 
j if incorrect length 








+ 20 




| Length (byte count) 




length 




+ 24 




| (Reserved) 








+ 28 




| Index to reference an element 
j in the DEB table of address 
j pointers to UCBs associated 
j with the DCB 




unit 




+ 29 




| Zeros 








+ 30 




| Zeros 








+ 31 




| Zeros 







L _L , JL J 



be specified in one DD statement; subse- 
quent DD statements can refer to the 
unspecified units in that group. Infor- 
mation about data definition specifi- 
cations can be found in IBM System/360 
Operating System; Job Control Language , 

The value of the "unit" operand 
decremented by 1 is placed in the data 
event control block (DECB) when it is 



generated 
("unit" - 1 
time, the 



at macro- expansion time 
= UCB index) . At execution 
Input/Output Control routine 



places this value into the input/output 
block (IOB). This completes the linkage 
between the input/output macro- instruc- 
tion and the selected UCB # which in turn 
points to the device associated with the 
macro- instruct ion. 



INPUT/OUTPUT MACRO- INSTRUCTIONS 



All input/output macro-instructions 
except the DCB macro- instruction may use 
the L- and E-forms of macro-definition. 
If all operands except the MF=L or MF=E 
keyword operand are written, the 
input/output function is executed using 
the specified operands. If any required 
operand is missing at execution time, 
the task is terminated. Detailed de- 
scriptions of these forms and their use 
are found in IBM System/360 Operating 
System; Control Program Services . 



A 3 2- byte DECB is formed at macro- 
expansion time and the parameters 
derived from the macro-instruction op- 
erands are inserted into appropriate 
positions in the DECB. This data is 
utilized by the Input/Output Control 
routine to generate the CCWs. The for- 
mat of the DECB for the IBM 2260 Local 
is shown in Table 2. 



The macro- instructions in this group 
implement 2260 input/output functions. 
They provide linkage to the Input/Output 
Control routine which creates the IOB, 
constructs channel programs, and issues 
calling sequences to execute the channel 
programs . 



Note: If an input/output operation 
depends upon the completion of a pre- 
vious input/output operation, a WAIT 
macro-instruction should be issued fol- 
lowing the macro- instruction initiating 
that previous input/output operation. 
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DCB — Data Control Block 
Macro- Instruction 



The DCB macro-instruction for the IBM 
2260 Local reserves space for the data 
control block and establishes its format 
(see Table 3). In addition to the basic 
information required in the DCB, space 
is also reserved for addresses of the 
Input/Output Control routine and the 
input/output block* which are supplied 
at open time. One DCB services a maxi- 
mum of 24 display stations and one 1053 
Printer attached to the same display 
control. The format of the DCB macro- 
instruction is : 



I Name 



_ T T _ 

| Operation | Operand 



j. + + -I 



[symbol] | DCB 
I 



| DSORG=GS , MACRF=code | 

| ,GTYPE=BASIC 

I [,DDNAME=symbol] 

| [ f EXLST=relexp] 

| [, GNCP=absexp] 

l ± J. J 



DSORG=GS 

Specifies that a graphic data 
control block is defined. This 
operand is required for macro- 
expansion. 



MACRF 



Specifies the type or types of 
macro- instructions to be used, 
where R indicates GREAD, W indi- 
cates GWRITE, and C indicates 
GCNTRL. The following are the 
eight valid forms of the MACRF 
operand. 



R 
W 
RC 

wc 

(R,W) 
(RC,W) 
(R,WC) 
(RC f WC) 

GTYPE=BASIC 

Specifies that basic attention han- 
dling procedures are to be em- 
ployed. 

DDNAME 

Specifies the name of the DD state- 
ment describing the data set being 
processed. DDNAME corresponds ex- 
actly to the contents of the Name 
field of the DD statement provided 
in the job control language. It 
can be defined by as many as eight 
characters , the first of which must 
be a letter. DDNAME furnishes a 
logical connection between the DD 
statement and the data control 
block of the user's problem pro- 
gram. 



EXLST 



Specifies the address of the user's 
exit list in the problem program as 
defined in IBM System/360 Operating 
System; Control Program Services . 
If EXLST is not specified, a value 
of zero is assumed. 



GNCP 



Specifies the maximum number of 
GREAD or GWRITE macro-instructions 
that can be issued before a WAIT 
macro-instruction (i.e.. the number 



Table 3. Data Control Block Elements 



Offset from 
DCB name 
(bytes) 
l_ + „ 

+0-13 | 

+ 14 | 

+15-25 | 

+26-27 | 

+28-31 | 

+ 32 | 

I 
+33-35 | 
+ 36 | 
+37-39 | 
+40-47 | 
+48-49 J 
+50-51 | 
J. 



DCB Field 
-I 

Reserved 

GTYPE — Specifies basic attention handling procedures 

Reserved 

DSORG — Specifies a graphic data control block 

Reserved 

GNCP — Maximum number of I/O macro-instructions issued before a 

WAIT macro-instruction is issued 
Reserved 
Reserved 

EXLST — Address of user's exit list for exceptional conditions 
DDNAME — Corresponds to name of data definition (DD) statement 
Reserved 
MACRF — Types of macro-instructions used in problem program 



10 



of IOBs constructed at open time) . 
The value of GNCP must be from 1 to 
99 at execution time. If the value 
of GNCP is not specified, a value 
of 1 is assumed. The programmer 
may specify a value of at assem- 
bly time, but must respecify the 
value within the above range at 
execution time. If the value is 
present at open time, the job is 
abnormally terminated. 



PROGRAMMING NOTES: The 
a DCB at assembly time by 
macro- instruction . Data 
card information may be s 
user at execution time, 
and may be specified at 
by a DD card, provided 
zero at assembly time. 



user may create 
use of the DCB 

Definition (DD) 

upplied by the 
The GNCP oper- 

execution time 
GNCP is set to 



The programmer can create his own DCB 
by using a constant area. In this case 
he may specify both the DSORG and GNCP 
operands in a DD card. By ensuring that 
this area contains the same information 
at the same locations as the DCB created 
by the DCB macro- expansion (see Table 
3), the user can effectively create a 
DCB. The DDname of the DD card must be 
identical to the DDname set up in this 
area (offset 40 through 47). For infor- 
mation on coding of the DD card, refer 
to the publication IBM System/360 Oper- 
ating System; Job Control Language . 



OPEN — Open Data Control Block 
Macro- Instruction 



The OPEN macro-instruction for the 
IBM 2260 Local initializes one or more 
data control blocks. 



- T T 

| Operation | Operand 
-+ +- 




(dcb-addr 
, , dcb-addr] . . .) 



,MF={ (E, 
1<E, 



listname )> 
(D) j 



deb 



Specifies the addresses of the DCBs 
to be initialized for the desired 
graphic device (s). Any number of 
DCB addresses may be specified. 
This allows parallel opening of 
DCBs and their associated data 
sets. If more than one DCB address 



is specified, the "deb" operands 
must be separated by two commas. 
The second comma indicates omission 
of optional operands not applicable 
to graphic programming services. 



MF=L 



Specifies that expansion of the 
macro-instruction is to consist of 
a parameter list only. The name 
assigned to the parameter list is 
the symbolic name specified in the 
Name field of this OPEN macro- 
instruction. 



MF= ( E , lis tname) 

Specifies that the macro-instruc- 
tion is to perform the open 
function using a parameter list 
created by another OPEN macro- 
instruction. The open function is 
executed for each "deb" operand in 
the list. The "listname" operand 
must correspond exactly to the name 
specified in the Name field of the 
OPEN macro- instruction used to 
construct the parameter list. 



MF=(E, (1)) 

Performs the same function as 
(E, listname) . By writing the spe- 
cial register notation (1) , the 
programmer specifies that he has 
loaded the address of the parameter 
list into register 1 before execu- 
tion of the macro- instruction. 

The OPEN macro-instruction fulfills 
the following functions: 

• Indicates that the device is "open" 
by setting the appropriate bit in 
the DCB. 

• Fills in and initializes appropriate 
fields in the DCB. 

• Acquires main storage to initialize 
a chain of IOBs and associated chan- 
nel programs. Linkage is provided 
in the IOB to its CCW list and to 
the' next IOB in the chain- The 
number of IOBs constructed is one 
greater than the number specified by 
the GNCP operand. The additional 
IOB is constructed in order to 
always ensure the availability of an 
IOB, since IOBs are not constructed 
dynamically. A pointer to the top 
of the chain of IOBs is placed in 
the DCB. 



Input/Output Control 11 



• Loads the graphic I/O Control rou- 
tine and places its address in the 
DCB. 

• Performs initialization functions 
required by attention-handling fa- 
cilities. 

EXAMPLES ; In the second and third exam- 
ples , DCB1 and DCB2 are initialized 
using the parameter list constructed by 
the first example. In the third exam- 
ple, the location of the parameter list 
has been loaded into register 1. 

EXAMP1 OPEN ( DCB1, , DCB2) , MF=L 
EXAMP2 OPEN MF= (E, EXAMP1) 
EXAMP3 OPEN MF= ( E r ( 1) ) 

PROGRAMMING NOTES: If the operand spe- 
cifies a DCB that is already open, no 
action results. If the operand does not 
specify the address of a valid DCB when 
opening, the job is abnormally terminat- 
ed. Opening when a corresponding DD 
statement has not been provided causes 
no error indication; however, an attempt 
to use the data set will result in an 
abnormal termination of the task. 

At execution time the OPEN routine 
checks the GNCP operand of the DCB 
macro- instruction. If the value of GNCP 
is zero or greater than 9 9 the task is 
abnormally terminated. 

If the device specified on the DD 
card is not a graphic device, an invalid 
UCB results, and the task is abnormally 
terminated. 



GREAD — Read Character Data 
Macro- Instruction 



The GREAD macro- instruction performs 
one of three functions, depending upon 
the "type" operand specified. The com- 
mands generated and their functions are 
explained in the following paragraphs. 



[symbol] | GREAD 



| Name | Operation | Operand j 

|. + + .| 

| decb-symbol 

| ,type-{DSM|SMI|DSB}| 

j ,dcb-addr 

j [, length-integer] 

j ,area-addr 

j [, unit-integer] 

| [,MF={L|E>] 

L JL ± J 



decb 

Is the name assigned to the data 
event control block generated in 
the macro-expansion. If this oper- 
and is missing, macro-expansion 
does not occur. 

type 

Specifies one of the following read 
operations: 

DSM 

Read Display Station Manual Input 
Message command for the 2260. 

SMI 

Read Display Station Short Manual 
Input Message command for the 2260. 

DSB 

Read Full Display Station Buffer 
Storage command for the 2260. 

deb 

Is the address of the data control 
block associated with the graphic 
device. 

length 

Is the number of data bytes to be 
read. 



area 



Is the address of the main storage 
location into which the first byte 
of data will be read. 



unit 



Is a decimal integer; it is used to 
create an index to the desired 
element in the DEB table (address 
pointers to UCBs associated with 
the DCB) . The indicated UCB con- 
tains the address of the desired 
device. The value of "unit" must 
be in the range 1 to N, where N is 
the number of devices specified on 
the Data Definition card for this 
data set. N cannot exceed 25 (the 
maximum configuration is 24 display 
stations and one 1053 Printer per 
display control) . 

Note : The device indicated by 
"unit" cannot be the 1053 Printer. 

Omission of the "unit" operand 
results in the value 1 being 
assigned to "unit", indicating the 
first element in the DEB table. 



MF=L 



Specifies that expansion of the 
macro-instruction is to consist of 
a parameter list only. The name 
assigned to the parameter list is 
the name specified by the "decb" 
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operand of this GREAD L-form macro- 
instruction. 

MF=E 

Specifies that the macro- instruc- 
tion is to perform the read 
function using a parameter list 
constructed by another GREAD macro- 
instruction. The first operand in 
the E-form macro- instruction must 
correspond exactly to the name of 
the parameter list. The parameter 
list may be updated at execution 
time by specifying new values in 
any of the operands preceding the 
MF=E keyword operand. 

All operands required for execution 
that were not specified in an L-form 
macro- instruction should be specified in 
the corresponding E-form macro- instruc- 
tion. 



Note: A unique name must be assigned to 
each parameter list defined. Use of the 
same DECS name for more than one DECB 
results in a multiple definition error 
at assembly time. 

If neither the MF=L nor MF=E keyword 
operand is written, the "decb" and "dcb n 
operands must be specified to accomplish 
macro- expansion. Omissions of other 
operands produce error messages on the 
assembly listing, but do not terminate 
macro- expans ion . 



TYPES OF READ OPERATIONS: The three 
types of read operations for the 2260 
are described below. 

DSM (Read Display Station Manual Input 
Message) : This command causes character 
data in the selected display station 
buffer storage to be processed and 
transferred to main storage by the dis- 
play control. DSM can be used only if 
either optional keyboard feature is 
available. Starting with the first dis- 
play position following the Start sym- 
bol, character data will be sequentially 
retrieved and transferred until the end 
of message is detected or the channel 
byte count is reduced to zero. The 
Start symbol is then cleared. Data on 
the same line and to the right of a New 
Line symbol is not transferred. If the 
Check symbol is present, it is trans- 
ferred. The end of message code is not 
transferred to main storage, and the CRT 
data display is not changed or destroyed 
J by the read operation. 



One channel command word is generated 
by GREAD, "type" DSM: the Read Display 
Station Manual Input Message command, 
which initiates the read operation. 

SMI (Read Display Station Short Manual 
Input Message) : This command is identi- 
cal to the DSM command, except that the 
Start symbol is not erased when the end 
of message is detected or the channel 
byte count is reduced to zero. Conse- 
quently, keyboard lockout time is sub- 
stantially less for the SMI command than 
for the DSM command. This is an impor- 
tant consideration for applications 
involving a high rate of data input and 
multiple 2260s attached to one 2848. 

One channel command is generated by 
GREAD, "type" SMI: the Read Display 
Station Short Manual' Input Message com- 
mand, which initiates the read opera- 
tion. 

DSB (Read Full Display Station Buffer) : 
This command transfers a maximum of 240, 
480, or 960 data bytes, depending upon 
the size of the addressed display sta- 
tion buffer. The first symbol trans- 
ferred is the first symbol in the upper 
left-hand corner of the CRT, and the 
last symbol transferred is the last 
symbol in the lower right-hand corner of 
the CRT. If no character is found in a 
displayable position, a space is trans- 
ferred. If the addressed buffer has the 
optional non- destructive cursor feature, 
the cursor position is not indicated by 
the data transferred. If the addressed 
buffer has a standard destructive cursor 
feature, the cursor position is indicat- 
ed by the location of the end of message 
code. The Check and Start symbols are 
transferred if they are present. The 
codes are: 



Destructive cursor 
Check symbol 
Start symbol 



bit 01234567 
01101010 
01111111 
01001010 



The CRT is erased after the opera- 
tion, and the cursor is placed in the 
first cursor position (upper left-hand 
corner) of the CRT. 

Multiple channel command words are 
generated by GREAD, "type", DSB. First, 
the Read Full Display Station Buffer 
command is issued, which initiates the 
read operation. Second, the Erase Dis- 
play Station Buffer Storage command is 
issued, which deletes all character data 
from the display station buffer storage 
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and resets the cursor to the first 
display position of the CRT. 

PROGRAMMI NG NOT ES ; If the channel byte 
count in the CCW reaches zero, a Stop 
sequence is generated by the channel. 
During a read operation, receipt of the 
Stop sequence terminates transmission of 
data from the display control to main 
storage. The display control continues 
reading data from the display station 
buffer storage but does not transfer 
data to main storage. Detection of the 
end of message when using DSM causes the 
display control to restore the keyboard 
of the selected display station and 
delete the Start symbol. When SMI is 
used, the keyboard is restored and the 
Start symbol is not erased. When DSB is 
used, the display is erased at comple- 
tion of the command, and the cursor is 
reset. If an error is detected during 
execution of the DSB command, the erase 
operation is not performed. The problem 
programmer , therefore, should ensure 
that the correct length is specified if 
he wants the erase operation to be 
performed. 

An unspecified "length" operand or 
zero entry results in the insertion of a 
byte count of 960 in the generated CCW. 
This assures that the Stop sequence will 
not be encountered on read operations. 
If the "length" operand is incorrectly 
specified, an error message is printed 
on the assembly listing. 

If incorrect length occurs during 
execution, the count from the CSW is 
placed in its appropriate location in 
the DECB (DECB+17), and a hexadecimal 
code of 43 is posted in the DECB 
(DECB+16) . Since this case is not con- 
sidered an error, a hexadecimal code of 
7F is also posted in the high-order byte 
of the ECB. If a permanent read error 
occurs, a hexadecimal code of 45 is 
posted in the DECB (DECB+16). If the 
read error occurs during a Read Display 
Station Manual Input Message (DSM) oper- 
ation, the screen is erased and the 
message ERR, RE-ENTER MSG is displayed. 
The 2260 operator may retype and re- 
enter the message. Should the error 
occur a second time, a message is typed 
for the system operator, and the display 
station should be considered inopera- 
tive. 

If the data control block address is 
not the address of a valid DCB, or if a 
required operand is missing, the task is 
abnormally terminated. 



EXAMPLES ; In the following example, a 
DECB named DECB1 is to be generated as 
part of the macro-expansion. The "type" 
operand specifies that a Read Display 
Station Manual Input Message command for 
the data set associated with the data 
control block INDCB will be performed. 
A length of 100 bytes will be read into 
an area in main storage called INAREA. 
The value of the "unit" operand is 1. 
In example 1 L-form is specified, which 
generates the parameter list. Example 2 
shows coding when positional operands 
are omitted in an L-form GREAD. Example 
3 shows the E-form GREAD with the length 
changed to 150 bytes. 



EXAMP1 GREAD 

EXAMP2 GREAD 
EXAMP3 GREAD 



DECB1 , DSM, INDCB, 100 , 
INAREA,1,MF=L 
DECB1,MF=L 
DECB1,,,150,MF=E 



Register Notation : The programmer may 
specify register notation, in which case 
the address of the DECB must be loaded 
into register 1 before execution of the 
macro-instruction. Other positional 
operands may be loaded into other reg- 
isters (2-12). For example: 



EXAMP1 


LA 


1,DECB 






GREAD 


(1),MF=E 




or 








EX AMP 2 


LA 


1,DECB1 






LA 


2^ INDCB 






LA 


3 r INAREA 






GREAD 


(1),,(2), 


, (3),MF=E 



GWRITE— Graphic Write Macro-Instruction 



The GWRITE macro-instruction is used 
to perform any of four functions depend- 
ing upon the "type" operand specified. 
The commands generated and their func- 
tions are explained in the following 
paragraphs. 

r t t 1 

| Name | Operation | Operand | 

h + + -i 



[symbol] | GWRITE 



L ± 



| decb- symbol 
| , type- {DSB |EBW| 
| LNE | EWL} 
| , dcb-addr 
| , [length-integer] 
| ,area-addr 
j [, unit-integer] 
| [,MF={L|E>] 
__L 



._j 
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decb 

Is the name assigned to the data 
event control block generated in 
the macro- expansion. This operand 
is required for macro-expansion, 

type 

Specifies one of the following 
write operations : 

DSB 

Write Display Station Buffer Stor- 
age command for the 2260, or Write 
1053 Printer Buffer Storage command 
for the 1053. 

EBW 

Erase and Write Display Station 
Storage command for the 2260. 

LNE 

Write Display Station Line Address 
command for the 2260. 

EWL 

Erase and Write Display Station 
Line Address command for the 2260. 



MF=L 



deb 



Is the address of the data control 
block associated with a graphic 
device. 



Specifies that expansion of the 
macro-instruction is to consist of 
a parameter list only. The name 
assigned to the parameter list is 
specified by the n decb n operand of 
this GWRITE L-form macro-instruc- 
tion. 

MF=E 

Specifies that the macro- 
instruction is to perform the write 
function using a parameter list 
constructed by another GWRITE 
macro-instruction. The first oper- 
and in the E-f orm macro-instruction 
must correspond exactly to the name 
of the parameter list. The param- 
eter list may be updated at execu- 
tion time by specifying new values 
in any of the operands preceding 
the MF=E operand. 

All operands required for execution 
that were not specified in an L-form 
macro-instruction should be specified in 
the corresponding E-form macro- 
instruction. 



length 

Is the number of bytes of display 
data to be written. This includes 
the New Line character and the Line 
Address control byte when used. 



area 



Is the address of the main storage 
location from which the first byte 
of display data is to be written. 



unit 



Is a decimal integer; it is used to 
create an index to the desired 
element in the DEB table (address 
pointers to UCBs associated with 
the DCB) . The indicated UCB con- 
tains the address of the desired 
device. The value of "unit" must 
be in the range 1 to N, where N is 
the number of devices specified on 
the Data Definition card for this 
data set. N cannot exceed 25 (the 
maximum configuration is 24 display 
stations and one 1053 Printer per 
display control) . 

Note : The 1053 Printer can be indi- 
cated by "unit" only when the 
"type" operand is written as DSB. 

Omission of the "unit" operand 
results in the value 1 being 
assigned to "unit", indicating the 
first element in the DEB table. 



Note; A unique name must be assigned to 
each parameter list defined. Use of the 
same DECB name for more than one DECB 
results in a multiple definition error 
at assembly time. 

If neither the MF=L nor MF=E keyword 
operand is written, the "decb" and "deb" 
operands must be specified to accomplish 
macro-expansion. Omissions of other 
operands result in error messages on the 
assembly listing, but do not terminate 
macro-expansion. 

TYPES OF WRITE OPERATIONS; The four 
types of write operations for the 226 
are described below. 

DSB (Write Buffer Storage) ; This com- 
mand causes sequential bytes of charac- 
ter data to be transmitted to the 
display control in either of two modes 
depending upon whether the address is 
specified as display station or 1053 
Printer. 



Upon recognition of 
tion address by the 
character data is 
display station buffer 
at the cursor symbol 
cursor is automatically 
next cursor position, 
placed in the first 
(upper left-hand corner 



the display sta- 

display control, 

placed into the 

storage starting 

position. The 

advanced to the 

The cursor is 

display position 

) of the CRT when 
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a displayable character is inserted into 
the last display position of the CRT. 

When the 1053 Printer address is 
recognized by the display control, 
incoming character data is placed into 
contiguous print positions of 1053 buf- 
fer storage and the 1053 print operation 
is initiated. A New Line character 
should be inserted at least after every 
130th character; otherwise, overprinting 
results. 



position of the cursor symbol. The 
cursor is automatically advanced to the 
next display position. 

LNE executes essentially the same 
command function as DSB. The basic 
difference is that information in the 
first data byte (a hexadecimal value in 
the range F0 through FB) , which must be 
supplied by the user, specifies the line 
to which the display data will be trans- 
mitted. 



If a write error occurs during execu- 
tion of a GWRITE, "type" DSB, operation, 
the system error recovery procedure 
erases the screen completely before ini- 
tiating a retry. 

One channel command word is generated 
by GWRITE, "type" DSB: the Write Buffer 
Storage command, which initiates the 
write operation. 

EBW (Erase and Write Display Station 



Buffer Storage) 



This 



command causes 
the display control to delete all char- 
acter data from the display station 
buffer storage, and to reset the cursor 
to the first display position (upper 
left-hand corner) of the CRT. The 
display data is then placed into display 
station buffer storage, starting with 
the position at which the cursor is 
reset. 

Two channel command words are gener- 
ated by GWRITE, "type" EBW. First, the 
Erase Display Station Buffer Storage 
command is issued to delete all charac- 
ter data from the display station buffer 
storage and reset the cursor to the 
first display position of the CRT. Sec- 
ond, the Write Display Station Buffer 
Storage command is issued to initiate 
the write operation. 



LNE 



(Write Display Station 



Line 



Address) : This command, which can only 
be used if the Line Addressing special 
feature is available, causes the display 
control to transmit sequential bytes of 
character data into the display station 
buffer storage under channel byte count 
control. The starting location in the 
display station buffer storage, as indi- 
cated in the first data byte, is inter- 
preted as a control byte. This byte 
specifies the line to which the display 
data will be transmitted (see Table 4). 
The cursor is moved to the first display 
position of the line indicated and 
display data is placed into display 
station buffer storage starting at the 



One channel command word is generated 
by GWRITE, "type" LNE: the Write Display 
Station Line Address command, which ini- 
tiates the write operation. 

Table 4. Format of First Data Byte for 
LNE or EWL 



| Bit Positions 


Hex. 


Selected 


| 1 


2 


3 


4 


5 


6 


7 


Equiv. 


Line 


L 












J- -L 


r 


















| 1 1 


1 


1 














F0 


one 


| 1 1 


1 


1 











1 


Fl 


two 


| 1 1 


1 


1 








1 





F2 


three 


| 1 1 


1 


1 








1 


1 


F3 


four 


1 1 1 


1 


1 





1 








F4 


five 


| 1 1 


1 


1 





1 





1 


F5 


six 


| 1 1 


1 


1 





1 


1 





F6 


seven 


| 1 1 


1 


1 





1 


1 


1 


F7 


eight 


| 1 1 


1 


1 


1 











F8 


nine 


1 1 1 


1 


1 


1 








1 


F9 


ten 


| 1 1 


1 


1 


1 





1 





FA 


eleven 


| 1 1 


1 


1 


1 





1 


1 


FB 


twelve 



EWL (Erase and Write Display Station 
Line Address) : This command, which can 
be used only if the Line Addressing 
special feature is available, causes the 
display control to delete all character 
data from the display station buffer 
storage, and resets the cursor to the 
first display position (upper left-hand 
corner) of the CRT. The cursor is moved 
to the first display position of the 
specified line and the display data is 
placed into the display station buffer 
storage starting at the position of the 
cursor symbol. The cursor is automat- 
ically advanced to the next display 
position. 

EWL executes the same command func- 
tion as LNE, except that the Erase 
command is performed first. 

Two channel command words are gener- 
ated by GWRITE, "type" EWL. First, the 
Erase Display Station Buffer Storage 
command is issued to delete all charac- 
ter data from the display station buffer 
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storage and reset the cursor symbol. 
Second, the Write Display Station Line 
Address command is issued to initiate 
the write operation. 



PROGRAMMING NOTES: 



block address is 
valid DCB, or if a required 
missing, the job is abnormally terminat- 
ed. 



If the data control 
not the address of a 
operand is 



EXAMPLE : 

DECB named DECBl is to be generated as 
part of the macro-expansion. The "type" 
operand specifies a Write Display Sta- 
tion Buffer Storage command for the data 
set associated with the data control 
block 0UTDCB. One hundred bytes of data 
will be written from an area in main 
storage called OUTAREA. The value of 
the "unit" operand is 1. In Example l f 
L-form is specified to generate the 
parameter list. Example 2 shows coding 
for an L-form GWRITE macro-instruction 
when positional operands are omitted. 
Example 3 shows coding for an E-form 
GWRITE macro- instruction with the length 
changed to 150 bytes. 



EXAMP1 GWRITE 



DECBl, DSB,OUTDCB, 100, 
OUTAREA, 1,MF=L 



EXAMP2 GWRITE DECBl, MF=L 

EXAMP3 GWRITE DECBl, ,, 150, MF=E 

Register Notation : The programmer may 
specify register notation. The address 
of the DECB must be loaded into register 
1 before execution of the macro- 
instruction. Other positional operands 
may be loaded into other registers 
(2-12). For example: 



EXAMP1 LA 

GWRITE 

or 

EXAMP2 LA 
LA 
LA 
GWRITE 



1, DECBl 
(1) ,MF=E 



1, DECBl 

2,OUTDCB 

3, OUTAREA 

(1),, (2),, (3),MF=E 



GCNTRL — Erase Display Station Buffer 
Storage Macro- Instruction 



The GCNTRL macro-instruction causes 
the display control to delete all 
character data from the display station 
buffer storage. 



r 

| Name 



■T T 

| Operation | Operand 



| [symbol] | GCNTRL 

1 1 
1 1 
1 1 
1 1 


| decb- symbol 

1 #type-ERS 

J ,dcb-addr 

| C , unit-integer] 

| [,MF={L|E>] 




L ± 


__X 


— j 



In the following example, a decb 



ERS 



deb 



Is the name assigned to the data 
event control block. This operand 
is required for macro- expansion. 



Specifies an Erase Display Station 
Buffer Storage command for the 
2260. 



Is the address of the data control 
block associated with the graphic 
device. 



unit 



Is a decimal integer; it is used to 
create an index to the desired 
element in the DEB table (address 
pointers to UCBs associated with 
the DCB) . The indicated UCB con- 
tains the address of the desired 
device. The value of "unit" must 
be in the range 1 to N, where N is 
the number of devices specified on 
the Data Definition card for this 
data set. N cannot exceed 25 (the 
maximum configuration is 24 display 
stations and one 1053 Printer per 
display control) . 

Note : The device indicated by the 
"unit" operand cannot be the 1053 
Printer, since an erase operation 
is invalid for the 1053 Printer. 

Omission of the "unit" operand 
results in a value of 1 being 
assigned to "unit", indicating the 
first element in the DEB table. If 
"unit" is incorrectly specified, an 
error message is printed on the 
assembly listing. 



MF=L 



Specifies that expansion of the 
macro-instruction is to consist of 
a parameter list only. The name 
assigned to the parameter list is 
the name specified by the "decb" 
operand of this GCNTRL L-form 
macro-instruction. 
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MF=E 

Specifies the macro-instruction is 
to perform the erase function using 
a parameter list constructed by 
another GCNTRL macro-instruction. 
The first operand in the E-form 
macro- instruct ion must correspond 
exactly to the name of the parame- 
ter list. The parameter list may 
be updated at execution time by 
specifying new values in any of the 
operands preceding the keyword 
operand. 

All operands required for execution 
that were not specified in an L-form 
macro- instruction should be specified in 
the corresponding E-form macro- 
instruction. 

Note: If the MF operand is omitted, the 
"decb" and "deb" operands are required 
for macro- expansion. Omissions of other 
operands result in error messages on the 
assembly listing , but do not terminate 
macro- expans ion . 



TYPE OF CONTROL OPERATION: Only one 
type of control operation is valid for 
the 2260 , the ERS (Erase Display Station 
Buffer Storage) . It causes the display 
station to delete all character data 
from the display station buffer storage. 
The cursor symbol is placed in the first 
display position of the CRT (upper left- 
hand corner) , and the remainder of the 
display is blank. 



EXAMP1 GCNTRL 



EXAMP2 GCNTRL 



EXAMP3 GCNTRL 



DECB1 , ERS , OUTDCB , 1 , 
MF=L 

DECB1,MF=L 

DECB1, , ,4,MF=E 



Register Notation : 



The programmer may 
notation. In such 
address of the 



specify register 

cases he must load the 

DECB into register 1 before execution of 

the macro-instruction. Other positional 

operands may be loaded into other 

registers (2-12). For example: 



EX AMP 1 


LA 


1,DECB1 




GCNTRL 


(1) ,MF=E 


or 






EX AMP 2 


LA 


1„DECB1 




LA 


2,4 




SLL 


2,24 




GCNTRL 


(1),,, (2 



When expressing the "unit" operand in 
register notation, as in EXAMP2, the 
value loaded into the register is the 
same as the one that would be used to 
express "unit" as a decimal integer. 
Note that the value for "unit" (4 in 
EXAMP2) is placed in the high-order byte 
of the register. 



CLOSE — Close Graphic Device 
Macro-Instruction 



GCNTRL, "type" ERS, generates one 
channel command word, the Erase Display 
Station Buffer Storage Control command, 
which initiates the erase operation. 

PROGRAMMING NOTES: If the data control 
block address is not the address of a 
valid DCB, or if a required operand is 
missing, the job is abnormally 
terminated. 

EXAMPLES : In the coding below, a DECB 
named DECB1 is to be addressed. The 
"type" operand specifies that an Erase 
Display Station Buffer Storage command 
for the data set associated with the 
data control block OUTDCB will be per- 
formed. The value of the "unit" operand 
is 1. L-form is specified in Example 1. 
Example 2 shows coding for an L-form 
GCNTRL macro-instruction when positional 
operands are omitted. Example 3 shows 
coding for an E-form GCNTRL macro- 
instruction when a positional operand is 
changed. 



The CLOSE macro-instruction disasso- 
ciates one or more data control blocks 
from the user's program. 



I Name 



h- 



_ T T 

| Operation | Operand 



[symbol] | CLOSE 



I 

-X. 



(deb-addr 
[ , , deb-addr] 



) 



,MF={ (E, listname)} 
l'(E, (1)) j 



-±J±L 



deb 



Are the symbolic addresses of the 
DCBs for the graphic device (s) 
being closed. Any number of DCB 
addresses may be specified. If 
more than one DCB address is speci- 
fied, the "deb" operands must be 
separated by two commas. The sec- 
ond comma indicates omission of an 
optional operand pertaining to vol- 
ume disposition, as explained in 
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the Control Program Services publi- 
cation, 

MF=L 

Specifies that expansion of the 
macro- instruction is to consist of 
a parameter list only. The name 
assigned to the parameter list is 
the name specified in the Name 
field of this CLOSE macro- 
instruction. 

MF= (E, listname) 

Specifies that the macro- instruc- 
tion is to perform the close 
functions using a parameter list 
constructed by another CLOSE macro- 
instruction. The close function is 
executed for each "deb" operand in 
the list. "Listname" must corre- 
spond exactly to the name specified 
in the Name field of the CLOSE 
macro-instruction used to construct 
the parameter list. 

MF=(E, (1)) 

Performs the same function as 
(E, listname) . By writing the 
special register notation (1), the 
programmer signifies that he will 
load the address of the parameter 
list into register 1 before macro- 
instruction execution. 



specify the address of a DCB, 
is abnormally terminated. 



the task 



The CLOSE macro- instruction 
the following functions: 



fulfills 



• Indicates that the DCB for the 
device is "closed" by setting the 
appropriate bit in the DCB. 

• Releases main storage acquired at 
open time, including the chain of 
IOBs and associated channel pro- 
grams, as well as storage acquired 
for attention handling functions. 



• Clears the fields in the 
tialized at open time. 



DCB ini- 



• Deletes attention routines associat- 
ed with the DCB being "closed." 

PROGRAMMING NOTES: If the operand spec- 
ifies a DCB that is already closed, no 
action results. If the operand does not 



Modifying the DECB at Execution Time 



Required parameters in the DECB may 
be modified at execution time by using 
an E-form macro-instruction. The fol- 
lowing programming considerations apply: 

1. Register notation may be specified. 
The register is loaded with the 
appropriate parameter before execu- 
tion of the macro-instruction. 

2. In using register notation, reg- 
isters 2 through 12 should be used 
except for the "decb" operand. 
Register 1 must be used for it. 

3. If the "type" operand is changed, 
it should only be specified by 
using an E-form macro-instruction 
containing the new "type" code. 
Register notation is not allowed 
for the "type" operand. 

Upon completion of an input/output 
operation, the completion flag in the 
event control block is set to 1. If an 
ECB is used for more than one 
input/output operation, it is the prob- 
lem programmer's responsibility to set 
the completion flag to before execu- 
tion of the second input/output opera- 
tion and all subsequent input/output 
operations that refer to that ECB. The 
following illustration shows the posi- 
tion of the completion flag in the ECB. 



ECB 
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Assume, for example, that a data 
event control block named DECB1 is to be 
used for two read operations.' The sec- 
ond GREAD macro-instruction can be 
preceded by the following line of code 
to clear the completion flag in the ECB. 

NI DECBl,X , BF f 
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BASIC ATTENTION HANDLING 



The operator at the 2260 Display 
Station can communicate information to 
the system through use of the alphameric 
keyboard or the numeric keyboard. Input 
from the keyboard results in an atten- 
tion (an unscheduled input/output 
interruption) . In order for such input 
to be meaningful, there must exist a 
routine, or routines, to be entered upon 
receipt of an attention. The program- 
ming support described in this section 
includes macro-instructions to help the 
user notify the system of the routines 
available for handling attentions. 

The following presentation consists 
of (1) a general discussion of basic 
attention handling, (2) detailed de- 
scriptions of macro-instructions, and 
(3) suggestions for a user's attention 
handling routine. 



BACKGROUND INFORMATION 



Basic attention handling provides the 
facilities to 

• Detect the occurrence of attentions 
automatically, by means of the asyn- 
chronous exit form of linkage (see 
IBM Operating System/360; Control 
Program Services ) . 

• Route these attentions to the user's 
attention handling routines. 

• Queue succeeding attentions, if nec- 
essary, until their routine is ready 
to process them. 

• Wait for expected attentions, 
optionally continuing selective pro- 
cessing in the meanwhile. 

Particular advantages of basic atten- 
tion handling are: 

• Attentions are not lost if the rou- 
tine designed to handle them is 
responding to an earlier attention 
at the time they are received. 

• Processing may be overlapped with 
attention input and/or operator 
response time. 



• System overhead is reduced, since 
there is no need to continually 
check for attentions. 

When the control program detects an 
attention from a 2260, it interrupts the 
currently processing routine (which may 
be an attention routine) and places the 
attention data on the queue of the 
highest priority attention routine for 
the device originating the attention 
that is either active or available . (To 
be available , a routine must be desig- 
nated by a SAEC macro-instruction for 
entry on receipt of a 2260 attention, 
and the associated GACB must have been 
specified by a , SPAR macro-instruction 
and not subsequently deleted by a DAR 
macro-instruction; see below. An active 
routine is one that is in control or has 
been interrupted. ) If no attention rou- 
tine for the device is available (or 
active) , the attention is lost. In 
either case, control then returns to the 
user's program. If the routine obtain- 
ing the queued attention had previously 
been inactive, it receives control; oth- 
erwise, control reverts to the routine 
just interrupted. 

When an attention routine is in con- 
trol, it processes the attentions on its 
queue in the order in which they 
occurred, unless an ATTNINQ macro- 
instruction within the routine instructs 
it to examine the queue for attentions 
from a particular display station. 

When an attention routine relinquish- 
es control (by means of the R mode of 
the ATTNINQ macro-instruction, or by 
executing a RETURN) , any attention 
remaining on its queue is serviced 
before the routine becomes inactive. 
Attentions may, however, be released 
from the queue without being serviced; 
this is done by the CLEAR mode of the 
ATTNINQ macro-instruction. 

The user can designate one attention 
handling routine to service attentions 
from all the graphic devices engaged in 
a task, or he can provide separate 
routines for individual devices. 

Whatever his decision as to how to 
handle attentions, the user must define 
his attention handling capability to the 
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system. He can do this with the follow- 
ing three macro- instructions: 

1. SAEC - This macro-instruction cre- 
ates a parameter list called a 
graphic attention control block 
(GACB) , which defines an attention 
handling routine and relates it to 
a data control block. 



COMAREA 

Specifies the address of a 
programmer-defined area in main 
storage, aligned on a full-word 
boundary and at least 16 bytes 
long, which is to be used by the 
control program to pass attention 
information to the attention rou- 
tine. 



2. SPAR - This macro-instruction acti- 
vates a previously existing GACB, 
i.e., makes the information it con- 
tains available to the control pro- 
gram. It also assigns priority, in 
the case of multiple attention rou- 
tines. 

3 . PAR - This macro-instruction is the 
inverse of SPAR, deleting control 
program references established by 
SPAR. 

One more macro-instruction, already 
mentioned, completes the set furnished 
by basic attention handling: 



4. ATTNINQ - This 



macro-instruction 



facilitates establishing and main- 
taining a communication sequence 
between the display station opera- 
tor and an attention handling rou- 
tine. 



SAEC — Specify Asynchronous Entry 
Conditions Macro-Instruction 



The SAEC macro-instruction establish- 
es a graphic attention control block 
(GACB) which defines an attention rou- 
tine. The GACB can subsequently be 
referred to by the symbolic name used 
for the SAEC macro- instruction. 



JName j Operation | Operand j 

I. + + ^ 

1 [symbol] |SAEC | [EP=addrx] [,DCB=addrx] [ , COMAREA=addrx] j 

j | | [,ATTNTYP=({A|S|R},2260) | SAVE | RESTORE] j 

| | | [,MF={L| (E,gacb-addrx)}] | 



EP 



DCB 



Specifies the entry point of an 
attention routine. 



Specifies the address of a DCB 
associated with the display sta- 
tion, or group of display stations, 
from which attentions are to be 
serviced. 



ATTNTYP 

Specifies the type of attention 
that will cause entry to the atten- 
tion routine. 

A, S, or R 

Specify, respectively, whether the 
information that follows is to be 
added to or subtracted from, or is 
to replace, the existing ATTNTYP 
field in the GACB. If this operand 
is omitted from an E-form of the 
macro-instruction, R is assumed. 

2260 

Specifies that the routine is to 
service attentions originating from 
a 2260. 

SAVE, RESTORE 

Specify, respectively, that the 
contents of the ATTNTYP field of 
the GACB are to be stored, or are 
to be replaced with the mask saved 
by a previous SAEC macro-instruc- 
tion with an ATTNTYP=SAVE operand. 

Note: The codes A, S, R, SAVE, and 
RESTORE are provided for compatibility 
with other graphic devices, which may 
allow for more than one type of atten- 
tion. 



MF=L 



Specifies that the macro-instruc- 
tion is to construct a GACB utiliz- 
ing the specified operands. Oper- 
ands omitted from the L-form cause 
the associated fields to be set to 
zeros. If neither the L- nor E- 
f orm is . specified, L is assumed. 
A, S, R, SAVE, and RESTORE are not 
relevant when the L-form of this 
macro-instruction is used. Omis- 
sion of the A, S, or R operand need 
not be indicated with a comma. 



MF=E 



Causes the GACB established by an 
L-form of this macro-instruction to 
be modified, as indicated by the 
other operands. If an operand is 
omitted, the corresponding field of 
the GACB is not affected. A comma 
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must show the omission of the A, S, 
or R operand. 



PROGRAMMING NOTES: The values specified 
for the COMAREA, DCB, ATTNTYP, and EP 
operands of the SAEC macro-instruction 
are inserted in the first, second, 
fourth, and fifth words of the GACB, 
respectively. All should be defined 
before a SPAR macro-instruction refer- 
ring to this GACB is issued. 



The DCB address in a GACB should not 
be changed without first deleting the 
attention routine with a DAR macro- 
instruction. After changing the DCB 
address, the routine must be respecified 
with a SPAR macro-instruction. 



EXAMPLES : 



GACBX1 SAEC 



EP=AR1 , DCB=GRAPHD1 t 

ATTNTYP=2260, 

COMAREA=AREAl 



The first four words of 
have the following format: 



the COMAREA 



r t t 1 

COMAREA +0| IX j RESERVED j TYPE | 
|. J. J. -i 

+4 j RESERVED j 

|. ! 

+8 j RESERVED j 

+12 j RESERVED | 

L J 



Field 



Contents 



RESERVED These fields are used by the 
control program. 



IX 



TYPE 



If multiple 2260s are assigned 
to a single DCB, this byte is 
set to an integer from 1 
through 25 to indicate which 
device originated the atten- 
tion that the routine has 
currently available for pro- 
cessing. The value of IX cor- 
responds to the position of 
the device in the device list 
supplied by the DD card and 
placed in the DEB by an OPEN 
macro- instruction. (IX func- 
tions in the same manner as 
the "unit" operand of the 
GREAD and GWRITE macro- 
instructions.) 

This is always a hexadecimal 
07, signifying a 2260 
attention. 



The user may add other fields to the 
COMAREA; see the suggestion under 
"User's Attention Handling Routine, w 
below. 

If an attention routine is to serve 
more than one device, and these devices 
have been specified in separate SAEC 
macro- instructions, its executable code 
must be reenterable. 



The GACB established by this macro- 
instruction can be referred to by the 
symbol GACBX1. The GACB defines an 
attention routine whose entry point is 
AR1. This routine is able to service 
attentions from the 2260 display station 
or stations associated with the 
identified DCB, and will receive atten- 
tion information in the COMAREA iden- 
tified by the symbol AREA1. Because the 
macro-form (MF) is not specified, L-form 
is assumed. 

EX2 SAEC DCB=GRPHDCB2 , EP= ( 3 ) , 
MF=(E,GACBX1) 

This macro- instruction changes the 
DCB address and the attention routine 
entry point in the GACB defined in the 
first example. 



Note: If this routine has been pre- 
viously specified (with a SPAR 
macro-instruction) it must be deleted 
(with a DAR macro-instruction) before 
changing the DCB address. After issuing 
the SAEC macro- instruction to change the 
DCB address, the attention routine must 
then be respecified before it is availa- 
ble to the system. 



SPAR — Specify Attention Routine 
Macro-Instruction 



The SPAR macro-instruction establish- 
es control program references to atten- 
tion routines, making them available for 
system use. 

r t t 1 

| Name | Operation | Operand | 

± + + ^ 

| [symbol] | SPAR | (gacb-addr [ , gacb-addr] . . . ) | 
j | | [,PRTY=integer] j 

| | | [,MF=L|(E,listname-addrx) ] j 
l j. x J 
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gacb 



Specifies the address of a graphic 
attention control block (GACB) , 
defined by a SAEC macro- 
instruction, which is to be made 
available to the system. 



PRTY 



Is a decimal integer from through 
127, used to determine priority 
among attention routines. Priority 
increases with numeric value (127 
gives highest priority) . No atten- 
tion routine may have control while 
a higher-priority routine for the 
same device has any processing to 
do. 



MF=L 



Specifies the construction of a 
list of GACB addresses which can be 
used by an E-form of either a SPAR 
or DAR macro-instruction. 

MF=E 

Specifies that the list of GACBs 
referred to by the "listname" 
operand is to be modified as indi- 
cated by the "gacb" operands, and 
that the GACBs in the list are then 
to be specif ied, i.e., made availa- 
ble for system use. The list can- 
not be lengthened or shortened by 
the E-form of this macro- 
instruction. 

listname 

Specifies the address of a list of 
GACBs established by an L-form SPAR 
macro- instruct ion. 



PROGRAMMING NOTES: The PRTY operand is 
provided primarily for compatibility 
with certain other graphic devices, 
which are capable of originating more 
than one type of attention. For such 
devices, the PRTY operand permits a 
routine designed to handle attentions of 
a particular type to interrupt another, 
less important, attention routine that 
handles attentions of another type from 
the same device. The programmer 
establishes the relative "importance" of 
routines for this purpose by use of the 
PRTY operand. This usage is not possi- 
ble on the 2260, which can originate 
only a single type of attention. There- 
fore, the PRTY operand can normally be 
omitted. 

) When the PRTY operand is omitted, a 
priority of is assigned. 



If more than one attention routine is 
available for any one 2260 at any time, 
and if these routines have been assigned 
the same numeric priority (as, for exam- 
ple, by omission of the PRTY operand) , 
the routine referred to last in the last 
SPAR macro-instruction has the highest 
priority. 

All attention handling routines take 
precedence over any background routine. 

An attention routine may be inter- 
rupted and immediately reentered if the 
same routine is defined in separate SPAR 
macro-instructions for two or more dis- 
play stations or if the routine is used 
by more than one task. Such a routine 
must be reenterable (it must not modify 
itself in any way)- 

•If the same GACB is referred to more 
than once in a SPAR macro-instruction, 
references after the first are treated 
as no-operations. A GACB address of 0, 
in a list of GACB addresses, will also 
be treated as a no-operation. 



ERROR CONDITIONS; 
tions will stop the 
of GACBs and cause 
Upon return to the 
will contain the 
associated with the 
register 15 will 
following return 
type of error: 



Certain error condi- 
processing of a list 
an immediate return. 

program, register 1 
address of the GACB 
error condition, and 

contain one of the 

codes to indicate the 



Return Code Error Condition 



04 



08 



0C 



EXAMPLES: 



GACB contains address of 
invalid DCB 

GACB already specified by a 
previous SPAR macro- 
instruction 

Request for main storage 
needed for control program 
references was not satis- 
fied 



EX1 SPAR (GACBX2) 

This macro-instruction establishes 
control references to the routine 
defined in a GACB identified by GACBX2. 

EX2 SPAR ( GACBX1 , NAME3 , T AG6 ) , MF=L 

This macro- instruction constructs a 
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list containing the three GACB addresses 
specified, 

EX3 SPAR (, ,GACBX3),MF=(E,EX2) 

This macro- instruction causes the 
parameter list constructed by EX2 to be 
modified, replacing the third GACB 
address (TAG6) with GACBX3. Control 
references are then established for the 
three GACBs referred to by the list. 



the task. Similarly, an attempt to 
delete an active attention routine will 
result in an error condition. 



ERROR 



CONDITIONS: 



Certain 



error 

conditions will stop the processing of a 
list of GACBs (or of one GACB) and cause 
an immediate return. Upon return to the 
program, register 1 will contain the 
address of the GACB associated with the 
error condition, and register 15 will 
contain a return code to identify the 
error condition as follows: 



PAR — Delete, Attention Routine 
Macro- Instruction 



The DAR macro- instruction is the 
inverse of the SPAR macro-instruction, 
deleting control program references and 
thus making an attention handling rou- 
tine unavailable for system use. 



Return Code Error Condition 



I Name 



h 



"T T 

| Operation | Operand 



[symbol] | DAR 



., 

| (gacb-addr [,gacb- | 
| addr]...) | 
I [,MF=L| (E, listname- | 
| addrx)] | 

-± j 



gacb 



Specifies the 
defining the 
be deleted. 



address of a GACB 
attention routine to 



MF=L 



Specifies formation of a list of 
the GACB addresses written in the 
macro- instruction. 

MF=E 

Specifies that the list of GACBs 
referred to by the "listname" oper- 
and is to be modified by the "gacb n 
operands, and that all attention 
routines referred to in the list 
are then to be deleted, i.e., made 
unavailable for system use. 

listname 

Specifies the address of a list of 
GACB addresses constructed by an 
L-form SPAR or DAR macro- instruc- 
tion. 



PROGRAMMING NOTES: 



The CLOSE function 
attention routines 
DCB. Howev- 



will delete all 
defined for the associated 
er, an attempt to issue a CLOSE macro- 
instruction from an attention routine 
will result in abnormal termination of 



04 



08 



0C 



GACB contains address of 
invalid DCB 



Routine not found 
specified by a 
macro-instruction) 

Routine active 



(not 
SPAR 



ATTNINQ — Attention Inquiry 
Macro-Instruction 



The ATTNINQ macro-instruction permits 
the selection of an attention from a 
particular display station from among 
all attentions on a queue, or entry into 
a wait state or temporary relinquishment 
of control pending a desired attention, 
or clearing of a queue. 



r t t 1 

j Name | Operation! Operand | 

|. + + .] 

| symbol | ATTNINQ Jgacb-addrx, | 

| | |MODE={R|W| (C,branch-addr) |CLEAR}| 

| | | [,UNIT=integer|ALL] | 

L JL JL J 



gacb 



Specifies the address of the 
ciated GACB. 



asso- 



MODE 



Specifies one of the four modes of 
inquiry, as follows: 

R 

Relinquish mode. The attention 
routine is to relinquish control 
until attention information from 
any display station the routine is 
servicing is available for that 
routine. When this information is 
available, processing continues 
with the next sequential instruc- 
tion. This mode is treated by the 
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system as a W (wait) mode if the 
ATTNINQ macro- instruction is issued 
from a routine entered by means of 
a LINK macro-instruction. 

W 

Wait mode. The task is to be 
placed in a wait state pending 
availability to it of attention 
information from the display sta- 
tion specified by the UNIT operand. 
This wait state does not prevent 
interruption by a routine that has 
been inactive, but prevents control 
from returning to an interrupted 
routine or one that has been in a 
wait state. When the wait condi- 
tion is satisfied, processing con- 
tinues with the next sequential 
instruction. 

C, branch 

Condition mode. If attention 
information from the device speci- 
fied by the UNIT operand is pres- 
ently queued for this routine, a 
branch is taken to the location 
specified by the "branch" operand; 
otherwise, processing continues 
with the next sequential instruc- 
tion. 

CLEAR 

Clear mode. All attentions queued 
for this routine are to be 
released, and control returned to 
the interrupted routine. 



must be observed (see the Control 
gram Services publication) . 



Pro- 



UNIT 



ALL 



Is a decimal integer from 1 through 
25, and corresponds to the position 
of the device in the device list 
supplied by a DD statement , where 
multiple devices are assigned to a 
single DCB. It is used as an index 
to select one of the several UCB 
addresses appended to the data ex- 
tent block (DEB) . The index value 
corresponding to the 1053 printer 
may not be specified. (This oper- 
and functions in the same manner as 
the "unit" operand of the GREAD and 
GWRITE macro-instruc- tions.) 



Specifies that an attention will be 
accepted from any 2260 assigned to 
the DCB. 



PROGRAMMING NOTES 



The ATTNINQ macro- 
may be issued only from 
scope of an attention 



instruction 
within the 
routine. Standard register conventions 



The UNIT operand must be used in 
conjunction with the W or C mode if 
there are multiple devices for the asso- 
ciated DCB. It is meaningless in con- 
junction with the CLEAR or R mode. 

Under R, W, or C mode, information 
pertaining to the attention that satis- 
fies the inquiry is made available in 
the COMAREA. 



USER'S ATTENTION- HANDLING ROUTINE 



The following notes may be helpful to 
a user writing a program designed for 
operator-machine communication. 



ESTABLISHING THE ATTENTION ROUTINE 



An attention routine is defined by 
means of a SAEC macro-instruction, which 
establishes a graphic attention control 
block (GACB) containing the information 
provided in the SAEC macro-instruction. 
In the GACB are: 

1. The address of the entry point of 
the associated attention routine. 

2. The address of a DCB associated 
with the device to be serviced. 

3. The address of a communication area 
(COMAREA) to be used to pass atten- 
tion information to the attention 
routine. 

The GACB thus provides a link between 
a display station, or group of display 
stations, and an attention routine. 

Although defined, an attention rou- 
tine is not available for use until it 
has been "specified" by means of a SPAR 
macro-instruction. This establishes 
control program references to it and, by 
means of a priority designation, estab- 
lishes its processing precedence in the 
hierarchy of attention routines. 

The DAR macro- instruction can be used 
to disable an attention routine which is 
no longer desired active although the 
associated DCB remains open. The SPAR 
and DAR macro- instructions may be 
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thought of as analogous to OPEN and 
CLOSE. 



Housekeeping/Background Routine 

1. Open the DCB for the display sta- 
tion or stations. 



PROCESSING THE ATTENTION 



Upon entry to an attention routine, 
register 1 contains the address of the 
GACB. In the first word of the GACB is 
the address of the communication area, 
or COMAREA. The first byte of the 
COMAREA points to the device that origi- 
nated the attention, if more than one 
device is assigned to the DCB, 



Use of the communication area allows 
the programmer to pass information 
between the housekeeping/background rou- 
tine and the attention routine (s). Each 
display station may be associated with 
its own communication area, and the 
attention data for each display station 
may be recorded independently of that 
for other display units. One of the 
fields in the communication area can be 
an ECB where completion of attention 
processing can be posted. The attention 
routine can post the appropriate ECB 
when it completes attention processing 
for that display station. 

Using the information available in 
the COMAREA and the DCB, the attention 
routine can perform necessary calcula- 
tions, issue appropriate input/output 
commands, and do whatever else is 
required to respond to the attention. 
If further communication from the dis- 
play station operator is required, an 
ATTNINQ macro- instruction can be used to 
relinquish control or enter a wait state 
until the desired attention occurs, or 
to set up a conditional branch based on 
its availability. 

When processing of the last attention 
of a communication sequence has been 
completed, the queue (for this routine) 
can be cleared by means of an ATTNINQ, 
mode CLEAR, macro- instruction before 
passing control to the interrupted rou- 
tine by means of the RETURN macro- 
instruction. 

Following is a brief outline of 
functions that might be performed by a 
housekeeping/background routine and by 
an attention handling routine. 



2. Establish the attention routine by 
means of the SAEC and SPAR macro- 
instructions. 

3. Issue input/output commands. 

4. Wait for posting of completion in 
the event control block (ECB) or 
perform background processing , 
which may or may not be related to 
the attention routine. 

5. Close the DCB. 

6. Indicate task completion by issuing 
the RETURN macro-instruction. 

Attention Routine 

1. Perform standard entry functions: 
save registers, establish address- 
ability, etc. 



2. Perform operations based 
attention information. 



on the 



3. Issue input/output commands. 

4. Wait for the next attention by 
means of the ATTNINQ macro- 
instruction. 

5. After the last attention is 
serviced, post completion in the 
ECB and return control to the back- 
ground routine by means of the POST 
and RETURN system macro-instruc- 
tions. 



SYNCHRONIZING THE USER'S ROUTINES 



Synchronization of the housekeeping/ 
background routine and the attention 
routine is the programmer's responsi- 
bility. He may use the WAIT system 
macro-instruction to delay execution of 
the housekeeping/background routine 
until completion has been posted in an 
ECB by the user's attention routine. 
The attention routine may either explic- 
itly post the ECB by means of the POST 
system macro-instruction or, by means of 
a user convention, locate the appropri- 
ate ECB via the graphic attention con- 
trol block and then post completion. 
The attention routine passes control 
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back to the housekeeping/background rou- routine when an attention occurs and the 

tine by means of the RETURN macro- returning of control to the interrupted 

instruction. Since completion has been (housekeeping/background) routine when 

posted, the housekeeping routine is completion is posted, continues as long 

taken out of its wait state and as the attention routine is defined and 

execution continues. This cycle, the as long as attentions occur, 
passing of control to the attention 
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APPENDIX A: SAMPLE PROGRAM 



Coding shown in Figure 3 is intended 
for use with one IBM 2260 Display Sta- 
tion (Local Attachment), equipped with 
the alphameric keyboard feature and 
without a 1053 Printer. 



Opening the DCB : The DCB for the 2260 
must be opened before any references are 
made to it. Up to 24 display stations 
and one 1053 Printer associated with a 
single DCB can be opened with one OPEN 
macro-instruction- 



For the purpose of this sample pro- 
gram, it is assumed that the first four 
characters of the manual input message 
contain a code which determines whether 
the routine processes the message and 
stores the results , or ends the job and 
displays results derived from the proc- 
essing of each individual request. 



The purpose of each element of the 
program is explained by the comments in 
the illustration. The following para- 
graphs point up applicable graphic pro- 
gramming considerations. 



Use of the GREAD Macro- Instruction : The 
GREAD macro- instruction shown in the 
coding generates a Read Display Station 
Manual Input (DSM) command. 

Use of the GWRITE Macro-Instruction ; The 
GWRITE macro- instruction shown issues an 
Erase and Write Display Station Buffer 
Storage (EBW) command to clear the stor- 
age and write a message to the operator. 
A Write Display Station Buffer storage 
(DSB) command is used when processing of 
a manual input request is completed and 
the operator is notified to submit the 
next request. 
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APPENDIX B: CCW'S ASSOCIATED WITH INPUT/OUTPUT CONTROL 



The following are formats 
macro- instructions are used. 



of CCWs generated when GREAD, GWRITE, and GCNTRL 



GREAD DSM CCW FORMAT 



Command 
Code 



Data 
Address 



Flags* 



Byte 
Count 



I 02 | 







7 8 



31 



T T 1 

I I I 
X X J 

32 33 34 



48 



63 



Command Name 
Read Display 
Station Manual 
Input Message 



T T 

I I 
J X 

35 36 

Function 

Causes character data in the display station 
buffer storage to be processed and transferred 
to main storage by the display control. The 
start symbol is erased 



H 



GREAD SMI CCW FORMAT 



Command 
Code 



Data 
Address 



Flags* 



Byte 
Count 



I 0A | 



"T" 

I 
-JL- 



I 
_X- 



"T" 

I 
-X- 



7 8 



31 32 33 34 35 36 



48 



63 



Command Name 

Read Display Station 

Short Manual 

Input Message 



Function 

Causes character data in the display station 
buffer storage to be processed and transferred 
to main storage by the display control. The 
start symbol is not erased. 



H 



GREAD DSB CCW FORMAT 



Command 
Code 



Data 
Address 



Flags* 



Byte 
Count 



06 



_ T T T - 

| 1 | 1 | 



-T" 

I 
_X- 



02 



7 8 



Command 
Code 



Data 
Address 



31 32 33 34 35 36 



Flags* 



48 



63 



Byte 
Count 



I 07 | 

L X 

7 8 

Command Name 
Read Full 
Display Station 
Buffer 



"T T T T T T" 

I I | 1 | | | 
-X X X X X x_ 



I 
_X- 



02 



31 32 33 34 35 36 



Function 



48 



63 



Two channel command words are generated. The 
Read Full Display Station Buffer command causes 
data starting at the first symbol in the upper 
left-hand corner of the CRT to be transferred to 
main storage. The Erase Display Station Buffer 
Storage command deletes all character data from 
the display station buffer storage and resets 
the cursor to the first display position of the 
CRT. 



* See key at end of table 
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GWRITE DSB CCW FORMAT 



Command 
Code 



Data 
Address 



Flags* 



Byte 
Count 



I 01 | 

L JL 

7 8 

Command Name 
Write Buffer 
Storage 



T 1 

I I 

J. J 

31 32 



T T T 1 

111 I I 
X X J. J 

33 34 35 36 
Function 



"T" 

I 
-JL_ 



48 



63 



Transmits sequential bytes of character data to 
the display control for output on the display 
station or 1053 Printer, 



H 



GWRITE EBW CCW FORMATS 



Command 
Code 



Data 
Address 



Flags* 



Byte 
Count 



r t~ 

I 07 | 

L JL_„ 

7 8 

Command 
Code 



-T T T" 

| 1 | 1 | 
_X X X- 



Data 
Address 



31 32 33 34 



Flags* 



X 

35 36 



I 
-JL- 



02 



48 



63 



Byte 
Count 



I 01 | 

L X 

7 8 

Command Name 
Erase and Write 
Display Station 
Buffer Storage 



T T T T T T" 

I I 111 I I 
X X X X X X- 

31 32 33 34 35 36 
Function 



I 
-X- 



48 



63 



Two channel command words are generated. The 
Erase Display Station Buffer Storage command de- 
letes all character data from the display sta- 
tion buffer storage and resets the cursor to the 
first display position of the CRT. The Write 
Display Station Buffer Storage command initiates 
the write operation. 



H 



GWRITE LNE CCW FORMAT 



Command 
Code 



Data 
Address 



Flags* 



Byte 
Count 



05 



L_ 





7 8 



Command Name 
Write Display 
Station Line 
Address 



T T T T T T" 

I I I 1 I I I 
X X X X X X- 

31 32 33 34 35 36 
Function 



I 

-X- 



48 



63 



Causes the display control to transmit sequen- 
tial bytes of character data into the display 
station buffer storage under channel byte count 
control. The first byte specifies the row to 
which the display data will be transmitted. The 
cursor is moved to the first display position of 
the row indicated and display data is placed 
into the display station buffer storage starting 
at the cursor symbol position. 



* See key at end of table 



(continued) 
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GWRITE EWL CCW FORMATS 



Command 
Code 



Data 
Address 



Flags* 



Byte 
Count 



| 07 

L 





_X__ 

7 8 



Command 
Code 



Data 
Address 



T T T T T T" 

I I 1 I 1 I I I 
X X X X J JL_ 

31 32 33 34 35 36 



Flags* 



"T" 

I 
_x_ 



02 



48 



63 



Byte 
Count 



I 05 ] 

L X 

7 8 

Command Name 
Erase and Write 
Display Station 
Line Address 



T 1 

I I 
X J 

31 32 



"T T - 

I 1 I 
-X X- 



"T" 

I 
-X- 



"T" 

I 
_X- 



33 34 35 36 



Function 



48 



63 



Two channel command words are generated. The 
Erase Display Station Buffer Storage command 
deletes all character data from the display 
station buffer storage and resets the cursor 
symbol to the first display position of the CRT. 
The Write Display Station Line Address command 
moves the cursor to the first position of the 
required line, and places display data into the 
display station buffer storage starting at the 
position of the cursor symbol. 



H 



GCNTRL ERS CCW FORMAT 



Command 
Code 



Data 
Address 



Flags* 



Byte 
Count 



I 07 | 

L X 

7 8 

Command Name 
Erase Display 
Station Buffer 
Storage 



T T T T T T" 

I I 111 I I 
X X X X X X- 

31 32 33 34 35 36 
Function 



"T" 

I 

-X- 



02 



48 



63 



Causes the display control to delete all charac- 
ter data from the display station buffer stor- 
age. The cursor symbol is placed in the first 
display position of the CRT and the remainder of 
the display is blank. 



*KEY 



Bit 33 — chain command flag 

Bit 34 — suppress length indication flag 



32 



GLOSSARY 



data control block (DCB) : Is the means 
by which the user transmits data-set- 
oriented information to the Input/Output 
Supervisor. 

data event control block (DECB) ; Is the 
name assigned to a block which contains 
the event control block and a parameter 
list which is constructed during the 
expansion of a GREAD, GWRITE, or GCNTRL 
macro- instruction. 

input/output block (IOB) ; Contains 
information required by the Input/ 
Output Supervisor to start an input/ 
output operation. This block points to 
the channel program that is to be exe- 
cuted. When the operations for that 
channel program terminate, the CSW is 
stored in the input/output block asso- 
ciated with the channel program. 

synchronous error : For the IBM 2260 
Local, an error that occurs during exe- 



cution of input/output operations before 
channel end. 



UCB index : Is an indexing factor used by 
the Input/Output Supervisor to refer to 
the appropriate device from a table of 
UCB addresses in the data extent block. 
It is derived by subtracting 1 from the 
value of the "unit" operand in 
input/output macro-instructions . The 
resulting value is placed in the data 
event control block, where it is availa- 
ble to the Input/Output Supervisor. The 
UCB index for unit 1 is 0, for unit 2 is 
1, and so on, up to a maximum of 25 
devices (24 display stations and 1 
printer) per display control. 



unit control block (UCB) 



contains information 
input/output unit to which it is 
ed. 



___ A block that 

describing the 

relat- 
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INDEX 



Where more than one reference is 
given,, the first page number indicates 
the major reference. 

alphameric keyboard 5,20 

attention . - 6,20 

attention handling, basic ... 20-27,6,12 

attention routine, 
user's 25-27,6,19,20 

attention type 21, 22 

ATTNINQ macro- 
instruction 24-25,20,21,26 

ATTNTYP 21,22 



basic attention handling 
buffer storage 



20-27,6,12 
5,13,16,18 



cathode ray tube (CRT) 5 

CCWs (channel command words) 6,14 

CCW formats 30-32 

channel byte count 13,14 

channel command words (CCWs) ...... 6,14 

character generator .....^ 5 

check symbol 13 

CLOSE macro- instruction 18-19, 8,24 

coding conventions 7 

COMAREA .. . 21, 22, 25, 26 

completion flag in ECB . . . 19 

conventions 6 

CRT ( cathode ray tube) 5 

cursor 5,13,14,15,16,17,18 

DAR macro- instruction 24-25,20,21 

data control 

block (DCB) 10-11,6,8,12,19,26,33 

data event control block 

(DECB) 9,12,13,14,15,19,33 

data extent block (DEB) 8 

DCB (data control 

block) 10-11,6,8,12,19,26,33 

DCB macro- instruction 10-11,8 

DD statement 8,11,12 

DDNAME 10 

DEB (data extent block) 8 

DECB (data event control 

block) 9,12,13,14,15,19,33 

destructive cursor 13 

DSB (read full display station 

buffer storage) 13-14,12,30 

DSB (write buffer storage) .... 15-16,31 
DSM (read display station \ 

manual input message) 13,12,30 

DSORG 10 



EBW (erase and write display 

station buffer storage) 16,15,31 

ECB (event control block) 14, 19, 2 6 

E-f orm macro- instructions 7,9 



end of message 13,14 

EP 21,22 

error handling . . 6 

errors, read 14 

errors, write 16 

ERS (erase display station 

buffer storage) 18,31 

event control block (ECB) ..... 14,19,26 
EWL (erase and write display 

station line address) 16-17,15,32 

EXLST , 10 

format illustration 
conventions 6 

glossary 33 

GACB (graphic attention 

control block) 21,22,23,24 

GCNTRL macro- instruction 17-18 , 8 

GNCP , 10,11 

graphic attention control 

block (GACB) 21,22,23,24 

GREAD macro-instruction 12-14,8 

GTYPE 10 

GWRITE macro-instruction 14-18 , 8 

IBM 1053 printer 8,13,15,16 

IBM 1053 printer adapter unit ........ 5 

IBM 2260 local 5 

IBM 2260 remote 5 

IBM 2701 data adaptor unit . 5 

IBM 2848 display control 5,8 

input/output block 

(IOB) 9,10,11,19,33 

input/output control 8-20 , 6 

input/output control routine ... 9,10,12 
input/output 

macro-instructions 8,9 

CLOSE 18-19, 8 

DCB 10-11,8 

GCNTRL 17-18,8 

GREAD 12-14,8 

GWRITE 14-18,8 

OPEN 11-12 , 8 

IOB (input/output 
block) 9,10,11,19,33 

keyboard 5,13,20 

L-f orm macro-instructions 7,9 

line addressing . - 5,16 

LNE. (write display station 

line address) 16,15,31 

linkage conventions 7 

MACRF codes 10 

macro-form operand (MF) 7,9 
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new line symbol 13, 16 

non- destructive cursor 5, 13 

numeric keyboard 5 f 20 



OPEN macro-instruction 11-12, 8 

POST macro-instruction 26 

printer adaptor unit • 5 

priority among attention 

routines 23, 20 

PRTY 2 3 

queuing of attentions • 20 

read error f 14 

register notation 14,17,18,19 

RETURN macro- instruction 20, 26 

SAEC macro- instruction 21-22,20,26 

sample program - 28 

SMI (read display station 

short manual input message) .. 13,12,30 
SPAR macro-instruction •. 22-23,20,21,26 

start symbol 13,14 

stop sequence 14 

synchronous error . . . . 6, 33 

system generation 6 

terminology 7,33 

UCB (unit control block) 8,9,33 

UCB index 8, 9, 33 

unit control block (UCB) 8,9,33 

unit operand 8-9,12,15,17,18, 

22,25,33 

WAIT macro-instruction 9,26 

wait state 25,26 

write error 16 
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